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Section  1 


1.1  Introduction 

As  personal  computers  grow  in  power  and  speed  and  hardware  costs  decline,  complex  3D 
simulations  that  once  required  multi-million  dollar  systems  are  now  capable  of  running  on  mass 
market  personal  computer  systems.  The  exponential  growth  of  the  internet  in  the  last  few 
years  has  led  to  a  substantial  number  of  commercial  games  and  simulations  that  use  the 
internet  to  link  together  remote  machines.  Moreover,  the  proliferation  of  Local  Area  Networks 
(LANs)  in  business  and  academic  institutions  has  led  to  an  increasing  demand  for  commercial 
games  and  simulations  that  can  run  on  a  LAN  topology.  Presently  there  exists  no  standard  for 
a  simulation  or  game  networking  protocol  and  architecture  in  the  commercial  sector.  Typically 
most  game  and  simulation  manufacturers  will  create  their  own  set  of  protocols  and  networking 
architectures  for  their  products.  As  a  result,  there  are  countless  solutions  in  place  for  linking 
together  various  commercial  games  and  simulations. 

HLA  shows  promise  for  creating  a  unified  standard  networking  architecture  that  can  be 
deployed  in  the  commercial  sector.  Currently  HLA  has  only  gained  widespread  acceptance 
within  the  Department  of  Defense.  Just  as  the  interoperability  of  various  simulations  is 
promised  by  HLA  within  DOD,  the  same  level  of  interoperability  can  be  brought  into  the 
commercial  sector. 

The  core  challenge  of  this  project  was  to  make  a  non-military  application  that  uses  HLA  and 
helps  promote  HLA  in  non-military  markets.  If  HLA  is  to  survive  and  flourish,  the  more 
industries  that  have  heard  of  HLA,  use  HLA  successfully,  and  acknowledge  what  it  offers,  the 
more  commercial  hardware  and  software  vendors  will  develop  tools  which  implement  and 
adhere  to  the  HLA  standard.  This  project  defines  a  path  to  accomplish  this  goal  in  the  video 
game  market  with  a  high  likelihood  of  success. 

The  original  networking  architecture  of  commercial  Spearhead  was  based  on  DIS-Lite,  which  is 
a  version  of  DIS  with  reduced  network  bandwidth  intended  for  PC  games.  Although  DIS-Lite 
requires  less  bandwidth  than  DIS,  its  architecture  remains  fundamentally  the  same. 

The  primary  goal  of  this  project  was  to  integrate  HLA  with  Spearhead,  MAK’s  completed,  state 
of  the  art,  Ml  A2  Abrams  tank  game.  The  game  was  originally  written  to  use  the  DIS-Lite  and 
VR-Link  2.4.x  networking  protocol  and  architecture  developed  by  MAK  technologies.  At  the 
commencement  of  this  effort,  Spearhead  was  in  Beta  form  and  all  networking  functionality  was 
virtually  complete.  The  non-HLA  version  of  Spearhead  permitted  players  to  engage  in 
distributed  interactive  games  over  LANs,  the  Internet,  NULL  modems  and  Dial  up  modems. 

A  secondary  goal  of  this  project  was  to  convert  MAK’s  existing  Spearhead-specific  lobby 
server  into  an  HLA  application.  A  “lobby  server”  is  an  application  that  runs  on  a  dedicated 
machine  connected  to  the  internet  via  a  T1  line.  The  Spearhead  lobby  server  is  a  C++ 
application  written  at  MAK.  The  existing  lobby  server  was  not  based  on  any  standardized 
protocol  or  architecture,  such  as  DIS,  instead  MAK  created  its  own  custom  lobby  server 
protocols.  This  means  the  lobby  server  would  need  to  be  re-written  to  use  HLA  and  the  RTI. 


The  primary  purpose  of  a  lobby  server  is  to  provide  a  point  of  entry  for  players  to  join  together 
in  a  simulation.  For  example,  if  a  player  wants  to  “host”  a  game  s/he  connects  to  the  lobby 
server  using  Spearhead  and  creates  a  hosted  game  that  other  players  may  join.  A  prospective 
player  would  then  connect  to  the  lobby  server  and  see  a  list  of  games  being  hosted.  The 
player  can  then  join  a  hosted  game  and  choose  a  team  (i.e.,  red  or  blue)  to  join.  While  games 
are  being  hosted,  players  can  chat  with  one  another,  enter  and  leave  hosted  games  and 
disconnect.  Once  the  host  is  satisfied  that  s/he  has  enough  players  for  their  game,  the  host 
starts  the  simulation.  At  that  point  the  game’s  mission  file  is  uploaded  from  the  lobby  server  to 
all  the  players  in  the  game.  Once  all  players  have  successfully  received  the  mission  file,  the 
players  are  now  communicating  peer  to  peer  and  are  disconnected  from  the  lobby  server. 

The  final  goal  was  to  create  a  new  real-time  RTI  specifically  aimed  at  the  game  market.  This 
RTI  would  allow  users  to  communicate  with  the  new  RTI  over  the  internet  using  dedicated  lines 
or  dial  up  modems  through  a  commercial  Internet  Service  Provider  (ISP). 


Summary  of  Results 

The  primary  goal  of  integrating  HLA  with  Spearhead  was  achieved.  VR-Link  2.4.x  and  DIS- 
Lite  were  replaced  by  VR-Link  3.x,  the  DMSO  RTI  (vl  .0  release  3)  and  a  modified  VR-Link  3.x 
federation  (FED)  file.  Nearly  all  the  functionality  of  the  DIS-Lite  version  was  ported  over  to 
HLA.  Presently,  HLA  Spearhead  will  run  existing  spearhead-specific  missions  in  single  or 
multiplayer  mode  on  a  LAN.  Essentially,  we  have  a  commercial  grade  3D  tank  simulation  that 
uses  HLA  for  single  and  multiple  federates.  Then  end  result  of  this  effort  demonstrates  that  it 
is  possible  to  create  a  commercial  grade  computer  game  using  HLA. 

The  secondary  goal  of  converting  MAK’s  internet  lobby  server  to  HLA  was  not  realized.  The 
principle  reason  was  the  amount  of  time  and  resources  required  to  convert  Spearhead  to  HLA. 
The  original  estimates  proved  inaccurate  owing  to  a  number  of  unforeseen  problems  and  side 
effects  resulting  from  the  conversion  effort  and  the  integration  of  VR-Link  3.x.  Moreover,  the 
DMSO  RTI  is  incapable  of  running  on  the  internet,  thus  MAK  would  have  had  to  create  an 
internet  capable  RTI  in  advance. 

However,  the  lobbying  functionality  required  for  playing  LAN  games  was  converted  to  use 
custom  HLA  interactions.  Many  of  these  lobbying  interactions  could  be  used  to  create  an 
internet  lobby  server.  It  is  worth  noting  that  the  fundamental  functions  and  architecture  of  LAN 
lobbying  are  identical  to  internet  lobbying  (i.e.,  listing  hosted  missions,  enumerating  players, 
chatting,  etc).  In  LAN  mode,  one  of  the  federates  becomes  a  “temporary”  lobby  server  until  all 
the  other  federates  have  joined  and  the  exercise  is  in  progress. 

Finally,  a  new  real-time  RTI  specifically  created  for  the  game  market  was  not  created.  There 
are  two  reasons  for  this: 

■  The  time  required  for  the  conversion  of  Spearhead  to  HLA  and  the  LAN  lobbying 
functionality  required  to  play  multiplayer  games  took  longer  than  expected. 

■  During  course  of  this  effort,  MAK  has  developed  its  own  real-time  RTI  that  will  be 
eventually  modified  to  support  internet  connectivity. 


1.3  Conclusion 


The  end  results  of  Phase  I  demonstrate  that  HLA  is  a  viable  architecture  for  developing 
commercial  grade  games  and  simulations.  HLA  has  the  functionality,  flexibility,  speed  and 
power  to  allow  a  wide  variety  of  commercial  grade  simulations  to  be  developed  and  deployed 
for  the  mass  market. 

Having  the  benefit  of  hindsight,  it  can  be  argued  that  it  is  easier  and  faster  to  develop 
commercial  games  and  simulations  using  VR-Link  3.x  with  modified  FOM  and  FED  files 
instead  of  using  VR-Link  2.4.x  with  game  specific  changes  to  DIS.  The  flexibility  and  ease  of 
use  of  the  FED  and  FOM  files  makes  it  relatively  easy  to  customize  and  develop  simulations 
based  on  the  RPR  FOM.  Moreover,  since  VR-Link  3.x  hides  many  of  the  RTI  specific  details, 
adding  and  modifying  new  HLA  interactions  is  easy. 

One  of  the  downsides  of  this  effort  were  the  problems  in  converting  a  DIS-Lite  application  to 
HLA.  Although  VR-Link  3.x  hides  many  of  the  implementation  details  of  DIS  versus  HLA  from 
the  user,  there  were  still  many  lines  of  code  that  required  modifications  on  account  of 
Spearhead-specific  deviations  from  the  standard  DIS  architecture. 

Before  HLA  can  be  deployed  and  accepted  in  the  commercial  sector  and  new  game-specific 
RTI  must  be  developed.  The  existing  DMSO  RTI  only  runs  on  LANs  and  the  RTI  EXEC  is 
command  line  application.  This  creates  some  problems  that  mitigate  against  the  use  of  the 
current  RTI  in  the  commercial  game/simulation  market: 

■  Any  commercial  multiplayer  game  must  run  on  the  internet.  Failure  to  do  so  is 
tantamount  to  market  suicide. 

■  Any  commercial  multiplayer  game  running  on  the  internet  must  support  direct 
connections,  such  as  T1  lines  as  well  as  dial  up  modems  via  an  ISP. 

■  A  commercial  game  or  simulation  needs  to  appear  seamless  to  the  end  user.  This 
means  no  game  publisher  is  ever  likely  to  accept  an  RTI  EXEC  running  as  a  stand 
alone  application  inside  a  DOS  window  within  Windows  95  or  NT.  In  other  words,  the 
RTIEXEC  should  be  invisible  and  hidden  from  the  user. 

However,  since  MAX  now  has  its  own  real-time  RTI,  we  can  modify  it  to  suit  the  above 
requirements.  Effectively,  there  are  no  technical  barriers  that  prevent  HLA  from  being  a  viable 
and  powerful  architecture  to  use  for  the  development  of  commercial  online  games  and 
simulations. 
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Section  2 


2.1  Proposal  Tasks 

This  section  will  cover  our  work  on  each  of  the  tasks  described  in  the  Phase  I  proposal.  Each 
section  includes  a  brief  discussion  of  our  work  on  the  task  along  with  references  to  the 
documentation  and  additional  materials  resulting  from  the  task. 

2.1 .1  Integrate  VR-Link  3.x  into  Spearhead 

Since  the  existing  Spearhead  application  was  based  on  VR-Link  2.4.x  and  DIS-Lite,  we  had  to 
remove  DIS-Lite  and  use  VR-Link  3.x  instead.  This  is  where  the  bulk  of  the  work  in  this  project 
was  expended.  Since  the  API  from  VR-Link  2.4.x  to  VR-Link  3.x  had  a  number  of  significant 
changes  in  structures  and  classes  and  the  API,  the  Spearhead  code  required  corollary 
modifications.  Since  many  of  these  classes  and  structures  were  used  throughout  the  code, 
there  were  literally  thousands  of  lines  of  code  that  required  minor  modifications.  Examples  of 
these  structures  and  classes  include  very  common  math  structures  such  vectors,  matrixes, 
etc. 

The  following  are  examples  of  such  changes.  Note  the  use  of  the  SPH_DIS_BUILD  compiler 
directive  to  differentiate  the  DIS  version  from  the  HLA  version. 


#ifndef  SPH_DIS_BUILD 
atVec.z  =  spReal(-cos(simAngles.psi)); 
atVec.y  =  spRealfO.); 
atVec.x  =  spReal(-sin(simAngles.psi)); 
#else 

atVec.z  =  spReal(-cos(simAngles.psi())); 
atVec.y  =  spReal(0.); 
atVec.x  =  spReal(-sin(simAngles.psi())); 
#endif 


#ifndef  SPH_DIS_BUILD 

DtSetVec(m_gravityVector,  0.0, 0.0,  -KtGRAVITY.CONSTANT); 
#else 

m_gravityVector  =  DtVector{0.0, 0.0,  -KtGRAVITY_CONSTANT); 
#endif 


#ifndef  SPH_DIS_BUILD 

void  GtSimBody::MeToWorld(DtDcm  meToWorld,  int  quickFlag) 
#else 

void  GtSimBody::MeToWorld(DtC)cmRef  meToWorld,  int  quickFlag) 
#endif 


#ifndef  SPH_DIS_BUILD 

return  m_draEntity->DtAcceleration; 

#else 

return  m_draEntity->en  tityState  Rep()->  acceleration  0 ; 
#endif//SPH_DIS_BU!LD 


For  the  commercial  version  of  Spearhead,  a  number  of  callback  functions  were  coded  for  the 
management  of  events  such  gun  fire,  detonate,  burst,  collisions,  etc.  Each  of  those  callback 
functions  required  some  level  of  modification  in  order  to  implement  their  HLA  equivalents.  This 
is  a  normal  side  effect  of  converting  DIS  PDUs  to  HLA  Interactions. 


2.1 .2  Re-Code  all  Spearhead-Specific  DIS  PDUs  to  HLA  Interactions 

Since  Spearhead  was  designed  to  be  a  game  for  the  commercial  sector,  it  was  necessary  to 
code  customized  DIS  PDUs  for  some  of  the  game’s  features.  The  two  main  areas  requiring 
custom  PDUs  were  the  game  lobbying,  including  chat  features,  and  the  IVIS. 


2.1. 2.1  Lobbying  Interactions 

As  mentioned,  the  lobbying  component  of  Spearhead  permits  players  on  LANs  and  the  internet 
to  join  together  to  play  a  hosted  game.  Some  of  the  LAN  lobbying  functions  were  implemented 
as  custom  DIS  PDUs,  naturally  they  required  to  be  converted  to  HLA  Interactions  before  a 
multiplayer  game  could  even  be  tested  in  HLA  Spearhead.  These  lobbying  functions  include: 

■  Chat.  During  the  lobbying  phase  it  is  imperative  that  players  have  the  ability  to  chat 
with  one  another.  The  chat  feature  allows  a  player  to  enter  a  text  message  which  is 
then  sent  to  other  players  on  the  system.  Chat  can  be  filtered  to  control  message 
flow.  For  example,  Spearhead  implements  “private”  and  “public”  chat  filters  that  allow 
the  player  to  select  whether  the  message  is  sent  to  only  one  selected  player  or  to  all 
players. 

■  Mission  File  Transfer.  Since  Spearhead  uses  mission  script  files  for  every  simulation 
that  is  run,  all  players  must  have  the  same  mission  file  before  the  simulation  can 
commence.  In  a  LAN  lobbied  game,  the  mission  is  sent  from  the  game  “host”  to  all 
the  players  that  have  joined.  In  other  words,  the  “host”  becomes  a  de-facto  temporary 
server  and  the  joiners  are  clients.  The  mission  file  is  then  sent  to  all  the  players  once 
the  host  elects  to  start  the  game.  The  Internet  case  is  somewhat  different  since  the 
lobby  server  has  a  copy  of  the  host’s  mission  file  in  memory.  Once  the  host  elects  to 
start  the  game,  the  lobby  server  sends  the  mission  file  to  all  the  players.  For  Phase  I, 
we  implemented  the  temporary  file  server  and  file  transfer  functions  for  LAN  games. 

■  Mission  Briefing  Transfer.  This  is  similar  to  the  file  transfer  functions  noted  above. 
In  this  case,  the  joiner  can  request  a  mission  briefing  from  the  host’s  machine.  The 
mission  briefing  contains  statistics  about  the  mission  (i.e.,  number  and  kind  of 
friendly/enemy  entities,  number  of  player  controlled  vehicles  on  each  team)  as  well  as 
a  few  paragraphs  of  text  explaining  the  mission  goals.  The  importance  of  this  feature 


Requests  that  an  entity  is  to  be  user-labeled  (string)  on  the  IVIS.  The  player  selects 
an  entity  to  label  and  can  assign  it  either  an  iconic  representation  (i.e.,  Main  Battle 
Tank)  or  a  text  label  (e.g.,”Red  Charlie”).  This  update  will  be  sent  to  all  the  players  on 
the  team.  The  remote  players  will  receive  an  interaction  to  update  both  the  icon  and 
text  label. 

SphCtrllVISEntityKillLabellnteraction 

Request  that  a  specific  IVIS  entity  label  (string)  should  be  removed.  The  player 
selects  an  entity  to  un-label.  The  selected  entity’s  icon  and  text  label  will  be  deleted 
and  the  entity  will  be  represented  by  a  question  mark  “?”  icon  to  indicated  an  unknown 
entity.  This  update  will  be  sent  to  all  the  players  on  the  team  and  their  representation 
of  the  selected  entity  will  be  marked  as  unknown. 

SphCtrllVISEntityMoveToInteraction 

Requests  a  specific  entity  to  move  to  a  given  coordinate.  The  player  selects  a  friendly 
entity  and  a  location.  If  the  friendly  entity  is  being  controlled  being  artificial  intelligence, 
then  the  entity  will  move  to  the  specified  location.  If  the  friendly  entity  is  a  player 
controlled  vehicle,  then  a  chat  message  of  the  form:  “ Move  To  at  123.89,  84.22” will  be 
displayed  to  the  player. 

SphCtrllVISEntityOrientationlnteraction 

Requests  a  specific  entity  to  orient  its  chassis  to  a  given  angle.  The  player  selects  a 
friendly  entity  and  then  a  point  on  the  map  to  orient  towards.  If  the  friendly  entity  is 
being  controlled  being  artificial  intelligence,  then  the  entity  will  orient  itself  towards  the 
specified  point.  If  the  friendly  entity  is  a  player  controlled  vehicle,  then  a  chat  message 
of  the  form:  ‘‘Set  Orientation  To  270”  will  be  displayed  to  the  player. 

SphCtrllVISEntityROEInteraction 

Requests  a  specific  entity  to  change  its  rules  of  engagement.  The  player  selects  a 
rule  of  engagement  such  as,  Weapons  Tight,  and  then  selects  a  friendly  entity.  If  the 
friendly  entity  is  being  controlled  being  artificial  intelligence,  then  the  entity  will  change 
its  rules  of  engagement.  If  the  friendly  entity  is  a  player  controlled  vehicle,  then  a  chat 
message  of  the  form:  “ Set  Rule  of  Engagement  to  Weapons  Tight”  will  be  displayed  to 
the  player. 


2.1 .2.3  Re-Coding  of  Game  Shortcuts  to  Reduce  Network  Bandwidth 

In  the  commercial  version  of  Spearhead,  we  made  several  shortcuts  to  reduce  network 
bandwidth.  For  example,  we  shortened  the  DIS  entity  identifier  to  use  only  a  player  number 
and  an  entity  number,  both  represented  as  unsigned  16  bit  integers.  Since  the  RTI  uses  its 
own  entity  ID  scheme,  with  HLA  entities  represented  as  unique  unsigned  32  bit  integers,  we 
needed  to  create  functions  and  macros  to  facilitate  the  conversion  to  HLA.  In  order  to  preserve 
as  much  as  the  code  as  possible,  we  created  functions  to  translate  an  HLA  ID  to  a  Spearhead 
Game  Entity  Identifier  and  vice-versa. 

One  problem  is  that  commercial  Spearhead  would  create  the  Game  Entity  Identifiers  based  on 
the  number  of  players  and  entities  in  the  exercise.  Normally  the  RTI  is  supposed  to  generate 
these  IDs  for  the  federates,  however  this  scheme  would  have  severe  side  effects  on  the 
remote  entity  identifier  paradigms  used  in  Spearhead.  For  example,  a  DIS-Lite 
DtGameEntityldentifier  is  constructed  based  on  the  following  rules: 


1 


The  Player  Identifier  is  based  on  the  nth  player  in  the  game  with  the  host  always  being  player 
ID  1  and  successive  players  joined  in  the  exercise  are  2,3,  and  so  on.  In  single  player  games, 
the  Player  ID  is  always  1 . 

The  entity  number  is  based  on  the  nth  entity  being  simulated  by  a  local  machine  (federate). 
The  first  entity  being  locally  simulated  (the  player  controlled  vehicle)  will  be  1 ,  the  next  will  be  2 
and  so  on.  Since  Spearhead  is  based  on  a  distributed  simulation  scheme,  simulation  of  Al 
controlled  entities  is  divided  equally  amongst  all  players  in  a  federation  (mission). 

Consider  a  simple  case  of  a  two  player  game  simulating  2  player  controlled  M1A2s  and  two  Al 
controlled  T-72s.  The  following  DtGameEntityldentifiers  would  be  generated: 


Entity 

Player  Identifier 

Entity  Number 

Player  1  M1A2 

1 

1 

Player  2  Ml A2 

2 

1 

T-72  #1 

1 

2 

T-72  #2 

2 

2 

Since  the  DtGameEntityldentifiers  are  algorithmically  derived,  we  needed  to  mimic  the  same 
algorithm  to  generate  HLA  identifiers.  Fortunately  version  1 .0  of  the  RTI  allows  the  application 
to  specify  its  own  HLA  identifiers  rather  than  relying  on  the  RTI  to  generate  them.  Within  VR- 
Link  3.x,  we  know  that  the  RTI  also  bases  unique  identifiers  on  the  number  of  players  and 
entities.  Using  the  above  rules  we  can  generate  the  following  HLA  Identifiers  for  our  simple  two 
player  game: 


Entity 

HLA  Identifier 

Player  1  M1A2 

100001 

Player  2  Ml  A2 

200001 

T-72  #1 

100002 

T-72  #2 

200002 

The  solution  to  maintaining  the  code  was  to  have  functions  that  transparently  convert  from  the 
DIS-Lite  identifier  scheme  to  the  HLA  identifier  scheme.  These  functions  were  significant 
since  entity  hashing  keys  are  all  based  on  the  game  generated  entity  identifiers.  In  the 
commercial  version  of  Spearhead,  we  use  the  tuple  DtGameEntityldentifier  to  perform  lookups 
in  the  HLA  version  we  use  an  unsigned  32  bit  integer  as  the  hash  key.  Naturally,  there  were 
many  places  in  the  code  that  required  that  the  identifiers  were  massaged  to  use  the  conversion 
functions. 

Note:  DtGameEntityldentifier  was  defined  a  tuple  for  DIS-Lite  implementation  and  as  a  32  bit 
unsigned  integer  for  HLA  implementation. 
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The  following  code  fragments  illustrate  how  these  conversions  were  accomplished. 


GtSimEntity*  GtSimEntityList::LookupEntity(DtGameEntityldentifier*  id) 


if  (lid) 

return  NULL; 

#ifndef  SPH_DIS_BUILD 
return  (GtSimEntity  *)lookup(id); 
#else 

DtHashKey  key((int)Cv20ID(*id)); 
return  (GtSimEntity  *)lookup(key); 
#endif 
} 


m_collisionPdu->setlssueld(  Cv20ID(  *Getld() ) ); 
m_collisionPdu->setCollideld{  Cv20ID(  *entity->Getld() ) ); 


DtG  ameEntityl  dentifier  attackerld  =  Cv2GEId(  detonatePdu->attackerld()  ); 
DtGameEntityldentifier  targetld  =  Cv2GEId(  detonatePdu->targetld() ); 


2.1 .3  Integrate  VR-LInk  3.x  into  existing  Lobby  Server 


No  work  done  on  this  task  since  there  was  no  time  left  over  from  the  conversion  of  Spearhead 
from  DIS-Lite  to  HLA.. 


2.1 .4  Design  and  build  new  Lobby  Server  functions  which  use  RTI  Services 


No  work  done  on  this  task  since  there  was  no  time  left  over  from  the  conversion  of  Spearhead 
from  DIS-Lite  to  HLA. 


2.1 .5  Design  Real-Time  RTI  for  Game  Market 

MAK  Technologies  now  has  its  own  RTI  that  will  be  customized  for  the  game  market.  The 
development  of  this  RTI  took  place  independently  of  this  SBIR. 


2.1.6  Final  Report 

This  report  along  with  appendices  and  attachments  detail  our  work  for  this  Phase  I  SBIR. 
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Section  3  Appendix  A  -  Source  Code  API  Samples 


3.1  Spearhead-Specific  Interactions 

3.1 .1  SphChatlnteraction 


typedef  void  (*SphChatlnteractionCb)(SphChatlnteraction*  inter,  void*  usr); 

class  SphChatlnteraction  :  public  Dtlnteraction 

{ 

public: 

SphChatlnteractionQ; 

SphChatlnteraction(const  RTI::ParameterHandleValuePairSet&  pvList, 
RTI::RTlambassador*  amb); 

SphChat!nteraction(const  DtGameEntityldentifier  &sendert 
const  DtGameEntityldentifier  &receiver, 

LPCTSTR  IptszMessage, 

GtTeamType  filter  =  GtTeamNeutral); 

II  copy  constructor 

SphChatlnteraction(const  Sph  C  h  at  l  n  teraction  &  ong); 
virtual  -SphChatlnteractionQ; 

II  assignment  operator 

SphChatlnteraction&  operator=(const  SphChatlnteraction&  orig); 

//get  the  paramater  handle  value  pair  set  for  the  interaction 
const  RTl::ParameterHandleValuePairSet&  phvps( 
RTI::RTIambas$ador*amb)  const; 

//set  the  values  from  parameter  value  list 

virtual  void  setFromPhvps(const  RTI::ParameterHandleValuePairSet&  pvList, 
RTI::RTiambassador*  amb); 

//get  the  interaction  class  handle 
virtual  RTI::lnteractionClas$Handie  interactionClassHandle( 
RTI::RTIambassador*  amb)  const; 

//get  the  number  of  parameters 
virtual  int  numParametersQ  const; 

//name  of  the  interaction 
virtual  const  char*  name()  const; 

//print  the  interaction's  data 
virtual  void  printData()  const; 

//accessors 

LPCTSTR  GetChatMessageQ  const; 

GtTeamType  TeamFilterQ  const; 
virtual  const  DtGameEntityldentifier&  Senderld()  const; 
virtual  const  DtGameEntityidentifier&  Receiverld()  const; 
virtual  const  DtObjectld&  HLASenderldQ  const; 
virtual  const  DtObjectld&  HLAReceiverldQ  const; 
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//mutators 


int  SetChatMessage(  LPCTSTR  IptszMessage,  GtTeamType  filter  =  GtTeamNeutral ); 

void  SetTeamFilter(GtTeamType  team); 

virtual  void  SetSenderld(const  DtGameEntityldentifier  &id); 

virtual  void  SetReceiverld(const  DtGameEntityldentifier  &id); 

virtual  void  SetHLASenderld(const  DtObjectld  &id); 

virtual  void  SetHLAReceiverld(const  DtObjectld  &id); 

public: 

//get  the  interacton  class  handle 

static  RTI: :  InteractionClassHandle  classHandle( 

RTI::RTIambassador*  amb); 

//create  a  SphChatlnteraction.  Caller  responsbile  for  deletion 
static  Dtlnteraction*  create(RTI::lnteractionClassHandle  h, 
const  RTI::ParameterHandleValuePairSet&  p, 

RTI::RTIambassador*  amb); 


II  Add  (register)/Remove  (deregister)  function  to  be  called 
II  when  the  interaction  occurs, 
static  void  addCallback(DtExerciseConn*  conn, 
SphChatlnteractionCb  cb,  void*  usr); 


static  void  removeCallback(DtExerciseConn*  conn, 

SphChatlnteractionCb  cb,  void*  usr); 

LPCTSTR  sphStmCpy(  LPTSTR  IptszDest,  LPCTSTR  IptszSrc,  sizej  count ); 
protected: 

//our  actual  data  to  be  sent/received 
GtTeamType  m_TeamFilter; 

TCHAR  m_tszChatMessage[MAX_CHAT_MSG_LEN  + 1]; 
DtGameEntityldentifier  m_Senderld; 

DtGameEntityldentifier  m_Receiverld; 

DtObjectld  mJHLASenderld; 

DtObjectld  m_HLAReceiverld; 


protected: 

//used  as  return  value  by  phvps  -  does  not  store  state 
static  RTI::ParameterHandleValuePairSet*  thePvList; 
}; 


3.1.2  SphCommentlnteraction 


typedef  void  (*SphCommentlnteractionCb)(SphCommentlnteraction*  inter,  void*  usr); 

class  SphCommentlnteraction :  public  Dtlnteraction 

{ 

public: 

SphCommentlnteraction(); 

SphCommentlnteraction(const  RTI::ParameterHandleValuePairSet&  pvList, 
RTI::RTIambassador*  amb); 
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SphCommentlnteraction(const  DtGameEntitylcJentifier  &sender, 
const  DtGameEntityldentifier  Receiver, 

LPCTSTR  IptszMessage, 

GtTeamType  filter  =  GtTeamNeutral); 


virtual  -SphCommentlnteractionQ; 

//get  the  paramater  handle  value  pair  set  for  the  interaction 
const  RTI::ParameterHandleValuePairSet&  phvps( 

RTI::RTIambassador*  amb)  const; 

//set  the  values  from  parameter  value  list 

virtual  void  setFromPhvps(const  RTI::ParameterHandleValuePairSet&  pvList, 
RTI::RTIambassador*  amb); 

//get  the  interaction  class  handle 

virtual  RTI::InteractionCiassHandle  interactionCla$sHandle( 

RTI::RTIambassador*  amb)  const; 

//get  the  number  of  parameters 
virtual  int  numParametersQ  const; 

//name  of  the  interaction 
virtual  const  char*  name()  const; 

//print  the  interaction’s  data 
virtual  void  printDataQ  const; 

//accessors 

LPCTSTR  GetChatMessage()  const; 

GtTeamType  TeamFilter()  const; 
virtual  const  DtGameEntityldentifier&  Senderld()  const; 
virtual  const  DtGameEntityldentifier&  ReceiverldQ  const; 

//mutators 

int  SetChatMessage(  LPCTSTR  IptszMessage,  GtTeamType  filter  =  GtTeamNeutral ); 

void  SetTeamFilter(GtTeamType  team); 

virtual  void  SetSenderld(const  DtGameEntityldentifier  &id); 

virtual  void  SetReceiverld(const  DtGameEntityldentifier  &id); 

public: 

//get  the  interacton  class  handle 

static  RT I : :  I  nteractionCI  ass  H  an  dl  e  classHandle( 

RTI::RTIambassador*  amb); 

//create  a  SphCommentlnteraction.  Caller  responsbile  for  deletion 
static  Dtlnteraction*  create(RTi::lnteractionClassHandle  h, 
const  RTi::ParameterHandleValuePairSet&  p, 

RTI::RTIambassador*  amb); 

II  Add  (register)/Remove  (deregister)  function  to  be  called 

II  when  the  interaction  occurs. 

static  void  addCal!back(DtExerciseConn*  conn, 

SphCommentlnteractionCb  cb,  void*  usr); 

static  void  removeCallback(DtExerciseConn*  conn, 

SphCommentlnteractionCb  cb,  void*  usr); 

LPCTSTR  sphStmCpy(  LPTSTR  IptszDest,  LPCTSTR  IptszSrc,  sizej  count ); 
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protected: 

//our  actual  data  to  be  sent/received 
GtT  eamT  ype  m_T  eamFilter; 

TCHAR  mJszChatMessage[MAX_CHAT_MSG_LEN  + 1]; 
DtGameEntityldentifier  m_Senderld; 

DtGameEntityldentifier  m_Receiverld; 


protected: 

//used  as  return  value  by  phvps  -  does  not  store  state 
static  RTl::ParameterHandieValuePair$et*  thePvList; 
}; 


3.1 .3  SphCtrlMSAirAttacklnteraction 


typedef  void  (*SphCtrllVISAirAttacklnteractionCb)(SphCtrl!VISAirAttacklnteraction*  inter,  void*  usr); 

class  SphCtrllVISAirAttacklnteraction  :  public  Dtlnteraction 

{ 

public: 

SphCtrl  I VI  SAi  rAttackl  nteraction(); 

SphCtrilVISAirAttackInteraction(const  RTI::ParameterHandleValuePairSet&  pvList, 
RT!::RTIambassador*  amb); 

SphCtrllVISAirAttacklnteraction(GtTeamType  senderTeam, 
double  x, 
double  y); 

virtual  ~SphCtrllVISAirAttacklnteraction(); 

//get  the  paramater  handle  value  pair  set  for  the  interaction 
const  RTI::ParameterHandleValuePairSet&  phvps( 

RTI::RTIambassador*  amb)  const; 

//set  the  values  from  parameter  value  list 

virtual  void  setFromPhvps(const  RTI::ParameterHandleValuePairSet&  pvList, 
RTI::RTIambassador*  amb); 

//get  the  interaction  class  handle 

virtual  RTI::InteractionCiassHandle  interactionClassHandle( 

RTI::RTJambassador*  amb)  const; 

//get  the  number  of  parameters 
virtual  int  numParametersQ  const; 

//name  of  the  interaction 
virtual  const  char*  nameQ  const; 

//print  the  interaction's  data 
virtual  void  printDataQ  const; 


//accessors 

const  GtTeamType  senderTeam()  const; 
const  double  X()  const; 
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//mutators 

void  SetSenderTeam(  const  GtTeamType  senderTeam ); 
void  SetX(  const  double  x ); 
void  SetY(  const  double  y ); 

public: 

//get  the  interacton  class  handle 

static  RTI::lnteractionClassHandle  classHandle( 

RTI::RTIambassador*  amb); 

//create  a  SphCtrllVISAirAttacklnteraction,  Caller  responsbile  for  deletion 
static  Dtlnteraction*  create(RTI::lnteractionClassHandle  h, 
const  RTI::ParameterHandleVa!uePairSet&  p, 

RTI::RTIambassador*  amb): 

II  Add  (register)/Remove  (deregister)  function  to  be  called 
II  when  the  interaction  occurs, 
static  void  addCal!back(DtExerciseConn*  conn, 
SphCtrllVISAirAttacklnteractionCb  cb,  void*  usr); 

static  void  removeCallback(DtExerciseConn*  conn, 
SphCtrilVISAirAttacklnteractionCb  cb,  void*  usr); 

protected: 

//our  actual  data  to  be  sent/received 
GtTeamT  ype  m__$enderT  earn; 

double  m_x; 

double  m_y; 

protected: 

//used  as  return  value  by  phvps  -  does  not  store  state 
static  RTI::ParameterHandleVa!uePairSet*  thePvList; 

}; 


3.1 .4  SphCtrlMSAirReconlnteraction 


typedef  void  (*SphCtrllVISAirReconlnteractionCb)(SphCtrllVISAirReconlnteraction*  inter,  void*  usr); 

class  SphCtrilVISAirReconlnteraction  :  public  Dtlnteraction 

{ 

public: 

SphCtrilVISAirReconlnteractionQ; 

SphCtiilVISAirReconlnteraction(const  RTI;:ParameterHandleValuePairSet&  pvList, 
RTI::RTIambassador*  amb); 

SphCtrl  I  VISAirReconlnteraction(GtT  eamT  ype  senderT  earn , 
double  x, 
double  y); 

virtual  ~SphCtrllVISAirReconlnteraction(); 

//get  the  paramater  handle  value  pair  set  for  the  interaction 
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RT I : :  RT I  ambassador^  amb)  const; 

//set  the  values  from  parameter  value  list 

virtual  void  setFromPhvps(const  RTI::ParameterHandleValuePairSet&  pvList, 
RTI::RTIambas$ador*  amb); 

//get  the  interaction  class  handle 
virtual  RTI::lnteractionClassHandle  interactionCiassHandle( 
RTI::RTIambassador*  amb)  const; 

//get  the  number  of  parameters 
virtual  int  numParameters()  const; 


//name  of  the  interaction 
virtual  const  char*  nameQ  const; 

//print  the  interaction's  data 
virtual  void  printData()  const; 

//accessors 

const  GtTeamType  senderTeamQ  const; 
const  double  X()  const; 
const  double  Y()  const; 

//mutators 

void  SetSenderTeam(  const  GtTeamType  senderTeam ); 
void  SetX(  const  double  x ); 
void  SetY(  const  double  y ); 

public: 

//get  the  interacton  class  handle 

static  RTi::InteractionClassHandle  classHandle( 

RTI::RTIambassador*  amb); 

//create  a  SphCtrllVISAirReconlnteraction.  Caller  responsbile  for  deletion 
static  Dtlnteraction*  create(RTI;:lnteractionClassHandle  h, 
const  RTl::ParameterHandleValuePairSet&  p, 

RTI::RTIambassador*  amb); 

//  Add  (register)/Remove  (deregister)  function  to  be  called 
//  when  the  interaction  occurs, 
static  void  addCallback(DtExerciseConn*  conn, 
SphCtrllVISAirReconlnteractionCb  cb,  void*  usr); 

static  void  removeCaIlback(DtExerciseConn*  conn, 
SphCtrliVISAirReconlnteractionCb  cb,  void*  usr); 

protected: 

//our  actual  data  to  be  sent/received 
GtTeamType  m_SenderTeam; 
double  m_x; 

double  m_y; 

protected: 

//used  as  return  value  by  phvps  -  does  not  store  state 
static  RTI::ParameterHandleValuePairSet*  thePvList; 

}; 
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3.1 .5  SphCtrllVISArtillerylnteraction 


typedef  void  (*SphCtrllVISArtillerylnteractionCb)(SphCtrllVISArti!lerylnteraction*  inter,  void*  usr); 

class  SphCtrllVISArtillerylnteraction :  public  Dtlnteraction 

{ 

public: 

SphCtrllVISArtiilerylnteractionQ; 

SphCtrllViSArtillerylnteraction(const  RTJ::ParameterHandleValuePairSet&  pvList, 
RTI::RTIambassador*  amb); 


SphCtiilVISArtillerylnteraction(GtTeamType  senderTeam, 
double  x, 
double  y); 

virtual  ~SphCtrllVISArtillery!nteraction(); 

//get  the  paramater  handle  value  pair  set  for  the  interaction 
const  RTI::ParameterHandleValuePairSet&  phvps( 

RTI::RTIamba$$ador*  amb)  const; 

//set  the  values  from  parameter  value  list 

virtual  void  setFromPhvps(const  RTI::ParameterHandleValuePairSet&  pvList, 
RTl::RTlambassador*  amb); 

//get  the  interaction  class  handle 
virtual  RTI::InteractionClassHandle  interactionClassHandle( 
RTI::RTIambassador*  amb)  const; 

//get  the  number  of  parameters 
virtual  int  numParametersQ  const; 

//name  of  the  interaction 
virtual  const  char*  name()  const; 

//print  the  interaction’s  data 
virtual  void  printDataQ  const; 

//accessors 

const  GtTeamType  senderTeam()  const; 
const  double  X()  const; 
const  double  Y()  const; 

//mutators 

void  SetSenderTeam(  const  GtTeamType  senderTeam ); 
void  SetX(  const  double  x ); 
void  SetY(  const  double  y ); 

public: 

//get  the  interacton  class  handle 

static  RTI::lnteractionClas$Handle  classHandle( 

RTI::RTIambassador*  amb); 

//create  a  SphCtrllVISArtillerylnteraction.  Caller  responsbile  for  deletion 
static  Dtlnteraction*  create(RTI::lnteractionClassHandle  h, 
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RTI::RTIambassador*  amb); 


II  Add  (register)/Remove  (deregister)  function  to  be  called 
II  when  the  interaction  occurs, 
static  void  addCallback(DtExerciseConn*  conn, 
SphCtrllVISArtillerylnteractionCb  cb,  void*  usr); 

static  void  removeCallback(DtExerciseConn*  conn, 
SphCtrllVlSArtillerylnteractionCb  cb,  void*  usr); 

protected: 

//our  actual  data  to  be  sent/received 
GtTeamType  m_SenderTeam; 
double  m_x; 

double  m_y; 


protected: 

//used  as  return  value  by  phvps  -  does  not  store  state 
static  RTI::ParameterHandleValuePairSet*  thePvList; 
}; 


3.1 .6  SphCtrllVISEntityEngagelnteraction 


typedef  void  (*SphCtrllVISEntityEngagelnteractionCb)(SphCtrllVISEntityEngagelnteraction*  inter,  void*  usr); 

class  SphCtiilVISEntityEngagelnteraction :  public  Dtlnteraction 

{ 

public: 

SphCtiilVISEntityEngagelnteraction(); 

SphCtrllVISEntityEngagelnteraction(constRTI::ParameterHandleValuePairSet&  pvList, 
RTI::RTIambassador*  amb); 

SphCtiilVISEntityEngage!nteraction(GtTeamType  senderTeam, 

DtGameEntityldentifier&  entitylD, 

DtGameEntityidentifier&targetID); 

virtual  ~SphCtrllVISEntityEngagelnteraction(); 

//get  the  paramater  handle  value  pair  set  for  the  interaction 

const  RTI::ParameterHandleValuePairSet&  phvps( 

RTI::RTIambassador*  amb)  const; 

//set  the  values  from  parameter  value  list 

virtual  void  setFromPhvps(const  RTI::ParameterHandleValuePairSet&  pvList, 

RTI::RTIambassador*  amb); 

//get  the  interaction  class  handle 

virtual  RTI::lnteractionClassHandie  interactionClassHandle( 

RTI::RTIambassador*  amb)  const; 

//get  the  number  of  parameters 

virtual  int  numParameters()  const; 
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virtual  const  char*  name()  const; 

//print  the  interaction's  data 
virtual  void  printData()  const; 

//accessors 

const  GtTeamType  senderTeam()  const; 
const  DtGameEntityldentifier&  entityIDQ  const; 
const  DtGameEntityldentifier&  targetlD()  const; 

//mutators 

void  SetSenderTeam(  const  GtTeamType  senderTeam ); 
void  SetEntitylD(  const  DtGameEntityldentifier&  id ); 
void  SetTargetlD(  const  DtGameEntityldentifierS  id ); 

public: 

//get  the  interacton  class  handle 
static  RT I : :  I  nteractionCl  assH  an  d  I  e  classHandle( 
RTI::RTIambassador*  amb); 


//create  a  SphCtrllVISEntityEngagelnteraction.  Caller  responsbilefor  deletion 
static  Dtlnteraction*  create(RTI::lnteractionClassHandle  h, 
const  RTI::ParameterHandleValuePairSet&  p, 

RTI::RTIambassador*  amb); 

II  Add  (register)/Remove  (deregister)  function  to  be  called 

II  when  the  interaction  occurs. 

static  void  addCallback(DtExerciseConn*  conn, 

SphCtrllVISEntityEngagelnteractionCb  cb,  void*  usr); 

static  void  removeCallback(DtExerciseConn*  conn, 
SphCtrllVISEntityEngagelnteractionCb  cb,  void*  usr); 

protected: 

//our  actual  data  to  be  sent/received 
GtTeamType  m_SenderTeam; 

DtGameEntityldentifier  m_entitylD; 

DtGameEntityldentifier  mjargetl  D; 

protected: 

//used  as  return  value  by  phvps  -  does  not  store  state 
static  RTI::ParameterHandieValuePairSet*  thePvList; 

}; 


3.1 .7  SphCtrlMSEntityKillLabellnteraction 


typedef  void  (*SphCtrllVISEntityKillLabellnteractionCb)(SphCtrllVISEntityKillLabellnteraction*  inter,  void* 
usr); 

class  SphCtrllVISEntityKillLabellnteraction :  public  Dtlnteraction 

{ 

public: 

SphCtrllVISEntityKillLabellnteractionQ; 
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RTI::RTIambassador*  amb); 

SphCtrHVlSEnlityKiillabellnteraction(GtTeamType  senderTeam, 
DtGameEntityldentifier&  entitylD); 

virtual  ~SphCtrllVISEntityKillLabellnteraction(); 

//get  the  paramater  handle  value  pair  set  for  the  interaction 
const  RTI::ParameterHandleValuePairSet&  phvps( 

RTI::RTIambassador*  amb)  const; 

//set  the  values  from  parameter  value  list 

virtual  void  setFromPhvps(const  RTl::ParameterHandleValuePairSet&  pvList, 
RTI::RT!ambassador*  amb); 

//get  the  interaction  class  handle 
virtual  RTI::lnteractionClassHandle  interactionClassHandle( 
RTI::RT!ambassador*  amb)  const; 

//get  the  number  of  parameters 
virtual  int  numParameters()  const; 


//name  of  the  interaction 

virtual  const  char*  name()  const; 

//print  the  interaction's  data 
virtual  void  printData()  const; 

//accessors 

const  GtTeamType  senderTeamQ  const; 
const  DtGameEntityldentifier&  entityIDQ  const; 

//mutators 

void  Set$enderTeam(  const  GtTeamType  senderTeam ); 
void  SetEntitylD(  const  DtGameEntityldentifier&  id ); 

public: 

//get  the  interacton  class  handle 

static  RTl::lnteractionC!assHandle  clas$Handle( 

RTI::RTIambassador*  amb); 

//create  a  SphCtrllVISEntityKillLabellnteraction.  Caller  responsbile  for  deletion 
static  Dtlnteraction*  create(RTl::lnteractionClassHandle  h, 
const  RTI::ParameterHandleValuePairSet&  p, 

RTI::RTlambassador*  amb); 

II  Add  (register)/Remove  (deregister)  function  to  be  called 

II  when  the  interaction  occurs. 

static  void  addCallback(DtExerciseConn*  conn, 

SphCtrllVISEntityKillLabellnteractionCb  cb,  void*  usr); 

static  void  removeCallback(DtExerciseConn*  conn, 

SphCtrllVISEntityKillLabellnteractionCb  cb,  void*  usr); 

protected: 

Hour  actual  data  to  be  sent/received 
GtT  eamT  y  pe  m_SenderT  earn; 

DtGameEntityldentifier  m_entitylD; 
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//used  as  return  value  by  phvps  -  does  not  store  state 
static  RTI::ParameterHandleValuePairSet*  thePvList; 

}; 


3.1 .8  SphCtrlMSEntityLabellnteraction 


typedef  void  (*SphCtrllVISEntityLabellnteractionCb)(SphCtrilVISEntityLabellnteraction*  inter,  void*  usr) 

class  SphCtrl  I V I  SEntity  Labetlnteraction :  public  Dtinteraction 

{ 

public: 

SphCtrll  VI S  Entity  Label  I  nteraction() ; 

SphCtr1IVISEntityLabellnteraction(const  RTI::ParameterHandleV  aluePairSet&  pvList, 
RTbRTIambassador*  amb); 

SphCtrllVISEntityLabellnteraction(GtTeamTypesenderTeam, 

DtGameEntityldentifier&  entitylD, 

GtBodyType  entityBodyType, 

GtTeamType  entityTeam, 

char*  szLabel); 


virtual  -SphCtrllVISEntityLabellnteractionQ; 

//get  the  paramater  handle  value  pair  set  for  the  interaction 
const  RTI::ParameterHandleValuePairSet&  phvps( 

RTI::RTIambassador*  amb)  const; 

//set  the  values  from  parameter  value  list 

virtual  void  setFromPhvps(const  RTI::ParameterHandleValuePairSet&  pvList, 
RTI::RTIambassador*  amb); 

//get  the  interaction  class  handle 
virtual  RTI::lnteractionClassHandle  interactionClassHandle( 
RTI::RTIambassador*  amb)  const; 

//get  the  number  of  parameters 
virtual  int  numParameters/)  const; 

//name  of  the  interaction 
virtual  const  char*  name()  const; 

//print  the  interaction's  data 
virtual  void  printData()  const; 

//accessors 

const  GtTeamType  senderTeam()  const; 
const  DtGameEntityldentifier&  entitylD()  const; 
const  GtBodyType  entityBodyType/)  const; 
const  GtTeamType  entityTeam/)  const; 
const  char*  label/)  const; 

//mutators 

void  SetSenderTeam/  const  GtTeamType  senderTeam ); 
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void  SetBodyType(const  GtBodyType  body); 
void  SetEntityTeam(const  GtTeamType  team); 
void  SetLabel(LPCSTR  szLabel); 


public: 

//get  the  interacton  class  handle 

static  RTl: :  I  nteractionCI  assHandle  classHandle( 

RTI::RTIambassador*  amb); 

//create  a  SphCtrilVlSEntityLabeilnteraction.  Caller  responsbile  for  deletion 
static  Dtlnteraction*  create{RTl::lnteractionClassHandle  h, 
const  RTI::ParameterHandleValuePairSet&  p, 

RTI::RTIambassador*  amb); 

//  Add  (register)/Remove  (deregister)  function  to  be  called 

//  when  the  interaction  occurs. 

static  void  addCallback(DtExerciseConn*  conn, 

SphCtrl  I VI  SEntity  Label  I  nteracti  on  Cb  cb,  void*  usr); 

static  void  removeCallback(DtExerciseConn*  conn, 

SphCtrl  I  ViS  Entity  Label  I  nteracti  on  Cb  cb,  void*  usr); 

protected: 

Hour  actual  data  to  be  sent/received 
GtTeamType  m_SenderTeam; 

DtGameEntityldentifier  m_entitylD; 

GtBodyType  m_BodyType; 

GtTeamType  m.entityTeam; 

char  m_szLabel[CTRLJVIS_ENTITY_LABEL_LEN  + 1]; 

protected: 

//used  as  return  value  by  phvps  -  does  not  store  state 
static  RTI::ParameterHandleValuePairSet*  thePvList; 

}; 


3.1 .9  SphCtrllVISEntityMoveT  olnteraction 


typedefvoid  (*SphCtrllVISEntityMoveTolnteractionCb)(SphCtrllVISEntityMoveTolnteraction’ 

usr); 

class  SphCtrllVISEntityMoveToInteraction  :  public  Dtlnteraction 

{ 

public: 

SphCtrilVISEntityMoveTolnteraction(); 

SphCtiilVlSEntityMoveTolnteraction(const  RTI::ParameterHandleValuePairSet&  pvList, 
RTI::RTIambassador*  amb); 

SphCtrilVISEntityMoveTolnteraction(GtTeamTypesenderTeam, 
DtGameEntityldentifier&entitylD, 
doublex, 
double  y); 

virtual  -SphCtrl I VI S EntityMoveT o I n teraction() ; 


inter,  void* 
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//get  the  paramater  handle  value  pair  set  for  the  interaction 
const  RTI::ParameterHandleValuePairSet&  phvps( 

RTl::RTIambassador*  amb)  const; 

//set  the  values  from  parameter  value  list 

virtual  void  setFromPhvps(const  RTI::ParameterHandleValuePairSet&  pvList, 
RTl::RTlambassador*  amb); 

//get  the  interaction  class  handle 
virtual  RTI : :  I  nteractionClassHandle  interactionClassHandie( 
RTI::RTIambassador*  amb)  const; 

//get  the  number  of  parameters 
virtual  int  numParametersO  const; 

//name  of  the  interaction 
virtual  const  char*  name()  const; 

//print  the  interaction's  data 
virtual  void  printDataQ  const; 

//accessors 

const  GtTeamType  senderTeamQ  const; 
const  DtGameEntityldentifier&  entityIDQ  const; 
const  double  X()  const; 
const  double  Y()  const; 

//mutators 

void  SetSenderTeam(  const  GtTeamType  senderTeam ); 
void  Set  Entity  I  D(con  st  DtGameEntityldentifier&  id); 

void  SetX(  const  double  x ); 

void  SetY(  const  double  y ); 
public: 

//get  the  interacton  class  handle 

static  RTI::lnteractionClassHandle  classHandle( 

RTI::RTIambassador*  amb); 

//create  a  SphCtrllVISEntityMoveToInteraction.  Caller  responsbile  for  deletion 
static  Dtlnteraction*  create(RTI::lnteractionClassHandle  h, 
const  RTI::ParameterHandleValuePairSet&  p, 

RTl::RTIambassador*  amb); 

II  Add  (register)/Remove  (deregister)  function  to  be  called 

II  when  the  interaction  occurs. 

static  void  addCallback(DtExerci$eConn*  conn, 

SphCtrllVISEntityMoveToInteractionCb  cb,  void*  usr); 

static  void  removeCa1lback(DtExerciseConn*  conn, 

SphCtrllVISEntityMoveToInteractionCb  cb,  void*  usr); 

protected: 

//our  actual  data  to  be  sent/received 
GtTeamType  m_SenderTeam; 

DtGameEntityldentifier  m.entitylD; 
double  m_x; 

double  m_y; 

protected: 
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static  RTi::ParameterHandleValuePairSet*  thePvList; 

}; 


3.1 .1 0  SphCtrllVISEntityOrientationlnteraction 


typedef  void  (*SphCtrllVISEntityOrientationlnteractionCb)(SphCtrllVISEntityOrientationlnteraction*  inter, 
void*  usr); 

class  SphCtrilVISEntityOrientationlnteraction :  public  Dtlnteraction 

{ 

public: 

SphCtrlIVISEntityOrientationlnteraction(); 

SphCtrllVISEntityOrientationlnteraction(const  RTI::ParameterHandleValuePairSet&  pvList, 
RTI::RTIambassador*  amb); 

SphCti1IVISEntityOrientationlnteraction(GtTeamType  senderTeam, 

DtGameEntityldentifier&  entitylD, 
int  heading); 

virtual  ~SphCtrllVISEntityOrientationlnteraction(); 

//get  the  paramater  handle  value  pair  set  for  the  interaction 

const  RTI::ParameterHandleValuePairSet&  phvps( 

RTI::RTIambassador*  amb)  const; 

//set  the  values  from  parameter  value  list 

virtual  void  setFromPhvps(const  RTl::ParameterHandleValuePairSet&  pvList, 

RTI::RTIambassador*  amb); 


//get  the  interaction  class  handle 
virtual  RTI::!nteractionClassHandle  interactionClassHandle( 
RTI::RTIambassador*  amb)  const; 

//get  the  number  of  parameters 
virtual  int  numParameters()  const; 

//name  of  the  interaction 
virtual  const  char*  name()  const; 

//print  the  interaction's  data 
virtual  void  printDataf)  const; 

//accessors 

const  GtTeamType  senderTeam()  const; 
const  DtGameEntityldentifier&  entitylDQ  const; 
const  int  heading/)  const; 

//mutators 

void  SetSenderTeam/  const  GtTeamType  senderTeam ); 
void  SetEntitylD(const  DtGameEntityldentifier&  id); 
void  SetHeading/  const  int  heading ); 

public: 
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static  RTI::lnteractionClassHandle  classHandle{ 

RTI::RTIambassador*  amb); 

//create  a  Sph Ctrl  I VI  SEntity Orientation  I nteraction .  Caller  responsbile  for  deletion 
static  Dtlnteraction*  create(RTI::lnteractionClassHandle  h, 
const  RTI::ParameterHandleValuePairSet&  p, 

RTI::RTIambassador*  amb); 

II  Add  (register)/Remove  (deregister)  function  to  be  called 

II  when  the  interaction  occurs. 

static  void  addCallback(DtExerciseConn*  conn, 

SphCtrl  I  VISEntityOrientati  on  Interaction  Cb  cb,  void*  usr); 

static  void  removeCallback(DtExerciseConn*  conn, 

SphCtrllVISEntityOrientationlnteractionCb  cb,  void*  usr); 

protected: 

//our  actual  data  to  be  sent/received 
GtTeamType  m_SenderTeam; 

DtGameEntityldentifier  m_entitylD; 
int  m_Heading; 

protected: 

//used  as  return  value  by  phvps  -  does  not  store  state 
static  RTI::ParameterHandleValuePairSet*  thePvList; 

}; 


3.1 .1 1  SphCtrllVISEntityROEInteraction 


typedef  void  (*SphCtrllVISEntityROEInteractionCb)(SphCtrllVISEntityROElnteraction*  inter,  void*  usr); 


class  SphCtrllVISEntityROEInteraction :  public  Dtlnteraction 

{ 

public: 

SphCtrllVISEntityROEInteractionO; 

SphCtrllVlSEntityROEInteractionfconst  RTl::ParameterHandleValuePairSet&  pvList, 
RTI::RTIambassador*  amb); 

SphCtrIIVISEntityROEInteraction(GtTeamTypesenderTeam, 
DtGameEntityldentifier&  entitylD, 

GtRuleOfEngagementArg  ROE); 

vi  rtu  a!  -SphCtrl  I VI  SEntity  ROE  I  ; 

//get  the  paramater  handle  value  pair  set  for  the  interaction 
const  RTI::ParameterHandleValuePairSet&  phvps( 

RTI::RTIambassador*  amb)  const; 

//set  the  values  from  parameter  value  list 

virtual  void  setFromPhvps(const  RTI::ParameterHandleValuePairSet&  pvList, 
RTI::RTIambassador*  amb); 

//get  the  interaction  class  handle 
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RT I : :  RT  iambassador*  amb)  const; 


//get  the  number  of  parameters 
virtual  int  numParameters()  const; 

//name  of  the  interaction 
virtual  const  char*  name()  const; 

//print  the  interaction's  data 
virtual  void  printData()  const; 

//accessors 

const  GtTeamType  senderTeam()  const; 
const  DtGameEntityldentifier&  entitylD()  const; 
const  GtRuleOfEngagementArg  ROEQ  const; 

//mutators 

void  SetSenderTeam(  const  GtTeamType  senderTeam ); 
void  SetEntitylD(const  OtGameEntityldentifierS  id); 
void  SetROE(  const  GtRuleOfEngagementArg  roe ); 

public: 

//get  the  interacton  class  handle 

static  RTI ::  I  nteractionClassH  andle  classHandle( 

RTI;:RTIambassador*  amb); 

//create  a  SphCtrll VI S Entity ROEInteraction .  Caller  responsbile  for  deletion 
static  Dtlnteraction*  create(RTI::lnteractionClassHandle  h, 
const  RTI::ParameterHandleValuePairSet&  p, 

RTI::RTIambassador*  amb); 

II  Add  (register)/Remove  (deregister)  function  to  be  called 

II  when  the  interaction  occurs. 

static  void  addCallback(DtExerciseConn*  conn, 

SphCtrilVISEntityROEInteractionCb  cb,  void*  usr); 

static  void  removeCallback(DtExerciseConn*  conn, 
SphCtrilVISEntityROEInteractionCb  cb,  void*  usr); 


protected: 

//our  actual  data  to  be  sent/received 
GtTeamType  m_SenderTeam; 

DtGameEntityldentifier  m_entitylD; 

GtRuleOfEngagementArg  m_ROE; 

protected: 

//used  as  return  value  by  phvps  -  does  not  store  state 
static  RTI::ParameterHandleValuePairSet*  thePvList; 
}; 


3.1.12  DtMachineGunFirelnteraction 


typedef  void  (*DtMachineGunFirelnteractionCb)(DtMachineGunFirelnteraction*  inter,  void*  usr); 
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f 


{ 

public: 

II  default  constructor 
DtMachineGunFirelnteraction(); 

//constaictor 

DtMachineGunFirelnteraction(  const  RTI::ParameterHandleValuePairSet&  pvList, 
RTI::RTIambassador*  amb ); 


//destructor 

virtual  -DtMachineGunFirelnteractionQ; 

//copy  constructor 

DtMachineGunFirelnteraction(const  DtMachineGunFirelnteraction&  orig); 

II  assignment  operator 

DtMachineGunFirelnteraction&  operator=(const  DtMachineGunFirelnteraction&  orig); 

II  Get  the  parameter  handle  value  pair  set  for  the  interaction. 

const  RTI::ParameterHandleValuePairSet&  phvps(  RTI::RTlambassador*  amb )  const; 

II  Decode  into  this  object  from  parameter  value  list, 
virtual  void  setFromPhvps(  const  RTi::ParameterHandleValuePairSet&  pvList, 
RTI::RTIambassador*  amb ); 

II  Get  the  interaction  class  handle. 

virtual  RTI::lnteractionClassHandIe  interactionClassHandle(  RTl::RTIambassador*  amb )  const; 

II  Get  the  number  of  parameters, 
virtual  int  numParameters()  const; 

II  Print  the  interaction's  data, 
virtual  void  printData()  const; 

II  Set/Get  the  attacker  identifier. 

void  setAttackerld(  const  DtGameEntityldentifier&  id ); 

virtual  const  DtGameEntityldentifier&  attackerldQ  const; 

void  setHLAAttackerld(  const  DtObjectld&  id ); 
virtual  const  DtObjectld&  HLAattackerldQ  const; 


II  Set/Get  the  starting  location  of  the  detonation  in  entity  coordinates, 
void  setStartLocation(  DtConstVector  location ); 
void  setStartLocation(  DtNetWorldCoordinates  loc); 

DtConstVector  startLocationQ  const; 

II  Set/Get  the  ending  location  of  the  detonation  in  entity  coordinates, 
void  setEndLocation(  DtConstVector  location ); 
void  setEndLocation(  DtNetWorldCoordinates  loc ); 

DtConstVector  endLocation()  const; 

II  Set/Get  the  burst  descriptor 

void  setBurst(  const  DtGameBursiDescriptor&  burst ); 

const  DtGameBurstDescriptor&  burst()  const; 

//Name  of  the  interaction 
virtual  const  char*  name()  const; 
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II  Get  the  interaction  class  handle. 

static  RTI::lnteractionClassHandle  classHandie(  RTI::RTIambassador*  amb ); 

II  Create  a  DtMachineGunFirelnteraction, 

II  Caller  is  reponsible  for  deletion. 

static  Dtlnteraction*  create(  RTl : :  I  nteractionClassHandle  h, 

const  RTI::ParameterHandleValuePairSet&  p, 

RTLRTlambassador*  amb ); 

II  Add  (register)/Remove  (deregister)  function  to  be  called  when 
II  interaction  occurs. 

static  void  addCallback(  DtExerciseConn*  conn,  DtMachineGunFirelnteractionCb  cb, 
void*  usr); 

static  void  removeCallback(  DtExerciseConn*  conn,  DtMachineGunFirelnteractionCb  cb, 
void*  usr); 


protected: 

II  Decode  into  this  object  from  parameter  value  list. 

II  Non-virtual  since  meant  to  be  called  from  ctor. 

void  internal$etFromPhvps(  const  RTI::ParameterHandleValuePair$et&  pvList, 
RTI::RTIambassador*  amb ); 


protected: 

DtGameEntityldentifier  myAttackerid; 

DtObjectld  myHLAAttackerld; 

DtVector  myStart; 

DtVector  myEnd; 

DtGameBurstDescriptor  myBurst; 

protected: 

static  RTI::ParameterHandleValuePairSet*  thePvList; 

}; 


3.1.13  DtMachineGunDetonationlnteraction 


typedef  void  (*DtMachineGunDetonationinteractionCb)(DtMachineGunDetonationlnteraction*  inter,  void* 
usr); 


class  DtMachineGunDetonationlnteraction  :  public  Dtlnteraction 

{ 

public: 

II  default  constructor 
DtMachineGunDetonationlnteraction(); 

II  constructor 

DtMachineGunDetonationlnteraction(  const  RTI::ParameterHandleValuePairSet&  pvList, 
RTI::RTIambassador*  amb ); 


//copy  constructor 

DtMachineGunDetonationlnteraction(const  DtMachineGunDetonationlnteraction&orig); 
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virtual  ~DtMachineGunDetonationlnteraction(); 


II  assignment  operator 

DtMachineGunDetonationlnteraction&  operator=(const  DtMachineGunDetonationlnteraction&  other); 

II  Get  the  parameter  handle  value  pair  set  for  the  interaction. 

const  RTI::ParameterHandleValuePairSet&  phvps(  RTI::RTIambassador*  amb )  const; 

II  Decode  into  this  object  from  parameter  value  list. 

virtual  void  setFromPhvps(  const  RTI::ParameterHandleValuePairSet&  pvList, 

RTI::RTIambassador*  amb ); 

II  Get  the  interaction  class  handle. 

virtual  RTI::lnteractionClassHandle  interactionCiassHandle(  RTI::RTlambassador*  amb )  const; 

II  Get  the  number  of  parameters, 
virtual  int  numParameters()  const; 

II  Print  the  interaction's  data, 
virtual  void  printData()  const; 

II  Set/Get  the  attacker  identifier. 

void  setAttackerld(  const  DtGameEntityldentifier&  id ); 

virtual  const  DtGameEntityldentifier&  attackerld()  const; 

void  setHLAAttackerld(  const  DtObjectld&  id ); 
virtual  const  DtObjectld&  HLAattackerid{)  const; 

II  Set/Get  the  target  identifier. 

void  setT  argetld(  const  DtGameEntityldentifier&  id ); 

virtual  const  DtGameEntityldentifier&  targetldQ  const; 

void  setHLATargetld(  const  DtObject!d&  id ); 
virtual  const  DtObjectld&  HLAtargetld()  const; 

II  Set/Get  the  starting  location  of  the  detonation  in  entity  coordinates, 
void  setStartLocation(  DtConstVector  location ); 
void  setStartLocation(DtNetWorldCoordinates  loc); 

DtConstVector  startLocationQ  const; 

II  Set/Get  the  ending  location  of  the  detonation  in  entity  coordinates, 
void  setEndLocation(  DtConstVector  location ); 
void  setEndLocation(DtNetWorldCoordinates  loc); 

DtConstVector  endLocation()  const; 

II  Set/Get  the  burst  descriptor 

void  setBurst(  const  DtGameBurstDescriptor&  burst ); 

const  DtGameBur$tDescriptor&  burst{)  const; 

II  Set/Get  the  entity  side 

void  setEntitySide(  DtEntitySide  side ); 

DtEntitySide  entitySide()  const; 

II  Set/Get  the  detonation  result 

void  setResu!t(  DtDetonationResult  result ); 

DtDetonationResult  resultQ  const; 

II  Name  of  the  interaction 
virtual  const  char*  name()  const; 
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public: 

II  Get  the  interaction  class  handle. 

static  RTI::!nteractionClassHandle  classHandle(  RTI::RTIambassador*  amb ); 

II  Create  a  DtMachineGunDetonationlnteraction. 

//Caller  is  reponsible  for  deletion. 

static  Dtlnteraction*  createf  RTI::lnteractionClassHand!e 

const  RTI::ParameterHandleValuePairSet&  p, 

RTI::RTIambassador*  amb ); 

II  Add  (register)/Remove  (deregister)  function  to  be  called  when 
II  interaction  occurs. 

static  void  addCallback(  DtExerciseConn*  conn,  DtMachineGunDetonationlnteractionCb  cb, 
void*  usr); 

static  void  removeCallback{  DtExerciseConn*  conn,  DtMachineGunDetonationlnteractionCb  cb, 
void*  usr); 


protected: 

II  Decode  into  this  object  from  parameter  value  list. 

II  Non-virtual  since  meant  to  be  called  from  ctor. 

void  intemalSetFromPhvps{  const  RTI::ParameterHandleValuePairSet&  pvList, 
RTI::RTIambassador*  amb ); 

protected: 

DtGameEntityldentifier  myAttackerld; 

DtGameEntityldentifier  myT  argetid; 

DtObjectld  myHLAAttackerld; 

DtObjectld  myHLATargetld; 

DtVector  myStart; 

DtVector  myEnd; 

DtGameBurstDescriptor  myBurst; 

DtEntitySide  mySide; 

DtDetonationResult  myResult; 

protected: 

static  RTI::ParameterHandleValuePairSet*  thePvList; 

}; 


3.1 .1 4  GntByteMoverlnteraction 

This  interaction  is  used  to  move  transfer  mission  files  and  mission  briefings  from  one  federate 
to  another. 

typedef  void  (*GntByteMoverlnteractionCb)(GntByteMoverlnteraction*  inter,  void  *usr); 

class  GntByteMoverlnteraction :  public  Dtlnteraction 

{ 
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GntByteMoverlnteraction(); 

GntByteMoverlnteraction(const  RTI::ParameterHandleValuePairSet&  pvList, 
RTI::RTIambassador*  amb); 

virtual  ~GntByteMoverlnteraction(); 

//get  the  paramater  handle  value  pair  set  for  the  interaction 
const  RTI::ParameterHandleVaIuePairSet&  phvps{ 

RTI::RT!ambassador*  amb)  const; 

//set  the  values  from  parameter  value  list 

virtual  void  setFromPhvps(con$t  RTI::ParameterHandleValuePairSet&  pvList, 
RTI::RTIambassador*  amb); 

//get  the  interaction  class  handle 
virtual  RTI::lnteractionClassHandle  interactionClassHand!e( 
RTI::RTIambassador*  amb)  const; 

//get  the  number  of  parameters 
virtual  int  numParameters()  const; 

//name  of  the  interaction 
virtual  const  char*  nameO  const; 

//print  the  interaction's  data 
virtual  void  printData()  const; 

//get/set  the  NumAlloc  parameter 
int  getNumAlloc()  const; 
void  setNumAiloc(int  num); 

//get/set  the  Buffer  parameter 
const  void*  getBuffer{)  const; 
void  setBuffer{const  void*  buff,  const  int  NumBytes); 

public: 

//get  the  interacton  class  handle 

static  RTI::lnteractionClassHandle  c!assHandle( 

RTl::RTIambassador*  amb); 

//create  a  GntByteMoverlnteraction.  Caller  responsbile  for  deletion 
static  Dtlnteraction*  create(RTI::lnteractionClassHandIe  h, 
const  RTI::ParameterHandleValuePairSet&  pt 
RTI::RTIambas$ador*  amb); 

II  Add  (register)/Remove  (deregister)  function  to  be  called 
II  when  the  interaction  occurs. 

static  void  addCallback(DtExerci$eConn*  conn, 

GntByteMoverlnteractionCb  cb,  void*  usr); 

static  void  removeCallback(DtExerciseConn*  conn, 
GntByteMoverlnteractionCb  cb,  void*  usr); 

protected: 

//our  actual  data  to  be  sent/received 
int  mJNumAlloc; 
void*m_pBuffer; 
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//used  as  return  value  by  phvps  -  does  not  store  state 
static  RTI::ParameterHandleValuePairSet*  thePvList; 


void  clearBuffer(); 

}; 


3.1.15  GntControlMessagelnteraction 


typedef  void  (*GntControlMessagelnteractionCb)(GntControlMessagelnteraction*  inter,  void  *usr); 

class  GntControlMessagelnteraction :  public  GntByteMoverlnteraction 

{ 

public: 

GntControlMessagelnteraction(); 

GntControlMessagelnteraction(const  RTI::ParameterHandleValuePairSet&  pvList, 
RTl::RTIambassador*  amb); 

virtual  ~GntControlMessagelnteraction(); 

//set  the  values  from  parameter  value  list 

virtual  void  setFromPhvps(const  RTi::ParameterHandleValuePairSet&  pvlist, 
RTI::RTIambassador*  amb); 

//get  the  interaction  class  handle 

virtual  RTI::lnteractionClassHandle  interactionClassHandle( 

RTl::RTIambassador*  amb)  const; 

//get  the  number  of  parameters 
virtual  int  numParametersQ  const; 

//name  of  the  interaction 
virtual  const  char*  nameO  const; 

//print  the  interaction's  data 
virtual  void  printDataQ  const; 

void  SetBufferAsStringfconst  char*  str); 

//accessors 

const  unsigned  long  GetCtrllD()  const; 

//mutators 

void  SetCtrJID(unsigned  long  id); 
public: 

//get  the  interacton  class  handle 

static  RTI::lnteractionClassHandle  classHandle( 

RTI::RTlambassador*  amb); 

//create  a  GntControlMessagelnteraction.  Caller  responsbile  for  deletion 
static  Dtlnteraction*  create(RTi::lnteractionClassHandle 
const  RTI::ParameterHandleValuePairSet&  p, 

RTI::RTIambassador*  amb); 
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II  Add  (register)/Remove  (deregister)  function  to  be  called 
II  when  the  interaction  occurs, 
static  void  addCallback(DtExerciseConn*  conn, 
GntControlMessagelnteractionCb  cb,  void*  usr); 

static  void  removeCallback(DtExerciseConn*  conn, 
GntControlMessagelnteractionCb  cb,  void*  usr); 

protected: 

unsigned  long  m_CtrIld; 
protected: 

//used  as  return  value  by  phvps  -  does  not  store  state 
static  RTI::ParameterHandleValuePairSet*  thePvList; 

}; 


3 2  Game  Entity  Identifier  Conversion  Functions 


#define  PLAYERDIV  100000 

const  DtGameEntity!dentifier&  Cv2GEId(const  DtObjectld&  id) 

{ 

static  DtGameEntityldentifier  GEId; 

DtU16  nPlayerld  -  id  /  PLAYERDIV; 

DtU16  nEntityNum  =  id  -  (nPlayerld  *  PLAYERDIV); 

GEId.init(nPlayerld,  nEntityNum); 
return  GEId; 

} 


const  DtObjectld&  Cv20ID(  const  DtGameEntityldentffier&  GEId ) 

{ 

static  DtObjectld  OID; 

RTI::ObjectlD  Id  =  (GEId.playerld()  ’  PLAYERDIV)  +  GEId. entityNumQ; 
OID  =  Id; 
return  OID; 

} 
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Section  4  Appendix  B  Federation  File  modifications 


The  following  excerpt  contains  the  modifications  made  to  the  Vr-Link.fed  file,  which 
incorporates  the  functionality  of  the  RPR  FOM. 


(class  ByteMover  FED.RELIABLE  FED.RECE1VE 
(parameter  NumAlloc) 

(parameter  Buffer) 

) 

(class  GntControIMessagelnteraction  FED_RELIABLE  FEDJRECEIVE 
(parameter  Ctrlld) 

(parameter  NumAlloc) 

(parameter  Buffer) 

) 

(class  SphCommentlnteraction  FED_REL1ABLE  FEDJRECEIVE 
(parameter  TeamFilter) 

(parameter  ChatMessage) 

(parameter  Senderld) 

(parameter  Receiverld) 

) 

(class  SphChatinteraction  FEDJREL1ABLE  FED_RECEIVE 
(parameter  TeamFilter) 

(parameter  ChatMessage) 

(parameter  Senderld) 

(parameter  Receiverld) 

) 

(class  SphCtrilVlSAirAttacklnteraction  FED_RELIABLE  FED_RECEIVE 
(parameter  SenderTeam) 

(parameter  X) 

(parameter  Y) 

) 

(class  SphCtrllVISAirReconlnteraction  FED_RELIABLE  FED_RECEIVE 
(parameter  SenderTeam) 

(parameter  X) 

(parameter  Y) 

) 

(class  SphCtrllVlSArtillerylnteraction  FED_REL!ABLE  FEO_RECEIVE 
(parameter  SenderTeam) 

(parameter  X) 

(parameter  Y) 

) 

(class  SphCtrllVISEntityEngagelnteraction  FED_RELIABLE  FED_RECEIVE 
(parameter  SenderTeam) 

(parameter  Entityld) 

(parameter  Targetld) 

) 

(class  SphCtrllVISEntityKillLabellnteraction  FED.RELIABLE  FED_RECEIVE 
(parameter  SenderTeam) 

(parameter  Entityld) 

) 

(class  SphCtiilVISEntityLabellnteraction  FEO.RELiABLE  FEDJRECEIVE 
(parameter  SenderT  earn) 

(parameter  Entityld) 

(parameter  BodyType) 

(parameter  EntityTeam) 
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(parameter  Label) 

) 

(class  SphCtrllVISEntityMoveToInteraction  FED_RELIABLE  FED_RECEIVE 
(parameter  SenderTeam) 

(parameter  Entityld) 

(parameter  X) 

(parameter  Y) 

) 

(class  SphCtrllVISEntityOrientationlnteraction  FED.RELIABLE  FED_RECEIVE 
(parameter  SenderTeam) 

(parameter  Entityld) 

(parameter  Orientation) 

) 

(class  SphCtrllVISEntityROEInteraction  FED_RELIABLE  FED_RECEIVE 
(parameter  SenderTeam) 

(parameter  Entityld) 

(parameter  ROE) 

) 

(class  MachineGunDetonationlnteraction  FED.RELIABLE  FED.RECEIVE 
(parameter  AttackerlD) 

(parameter  TargetID) 

(parameter  StartLocation) 

(parameter  EndLocation) 

(parameter  Burst) 

(parameter  EntitySide) 

(parameter  Result) 

) 

(class  MachineGunFirelnteraction  FED_REL1ABLE  FEO_RECEIVE 
(parameter  AttackerlD) 

(parameter  StartLocation) 

(parameter  EndLocation) 

(parameter  Burst) 

) 
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Section  5  Installing  the  HLA  Spearhead  Demo  CD 


The  Phase  I  effort  of  this  SBIR  has  an  install  program  that  will  install  both  HLA  Spearhead  and 
the  RTI.  The  process  requires  a  few  simple  steps  that  the  user  must  perform. 


5.1  System  Requirements 

Windows  95  (will  not  run  under  Windows  NT) 

Pentium  120  MHz  or  higher  based  system,  Pentium  166Mhz  or  higher  recommended. 
16MB  RAM  minimum,  32MB  recommended 

Windows  95  compatible  video  card  capable  of  16  BPP  resolution  (64K  colors) 
Windows  95  compatible  16  or  32  bit  sound  card  (e.g.,  Sound  Blaster) 

Windows  95  compatible  LAN  card  with  TCP/IP  support  installed. 

280MB  Free  hard  disk  space 

Microsoft  Direct  X  version  5.0  (supplied  on  HLA  Spearhead  CD-ROM) 


52  Installation  Steps 

1 .  The  first  step  is  to  install  Microsoft  Direct  X,  since  Spearhead  cannot  run  without  it.  Direct  X 
technology  provides  specialized  interfaces  to  PC  hardware  so  games  can  run  an  optimal 
speed  under  Windows  95.  Perform  these  steps  to  install  Direct  X. 

Insert  the  HLA  Spearhead  CD-ROM  in  your  CD-ROM  drive.  The  CD-ROM  uses  the  auto  start 
feature  of  Windows  95,  which  means  you  automatically  see  the  following  screen  after  a  few 
seconds. 
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If  Direct  X  5  is  not  installed  on  your  system,  then  you  should  click  the  Install  Direct  X  5  button. 
When  Direct  X  is  done  installing,  you  must  re-boot  your  system. 

2.  The  second  step  is  to  install  Spearhead.  You  can  click  over  the  Install  Spearhead  button, 
or  run  the  SETUP.EXE  program  on  the  CD-ROM.  Just  follow  the  all  the  default  prompts. 
Once  the  setup  is  complete,  you  should  have  an  HLA  Spearhead  folder  in  your  Start 
menu.  Setup  will  create  the  following  menu  items  in  the  HLA  Spearhead  folder: 

•  Control  Setup 

•  Spearhead 

•  RTI  Exec 

•  Mission  Editor 

•  ReadMe 

•  Uninstall  Spearhead 

3.  If  you  have  a  3DFX  based  graphics  accelerator,  such  as  the  Voodoo  3D  or  Monster  3D 
boards,  make  sure  you  have  the  latest  version  of  the  Glide  Drivers  installed.  If  you  are  not 
sure  about  this,  there  is  a  3DFX_Drivers  folder  on  the  CD-ROM  that  contains  3DFX  Glide 
drivers  that  will  work  with  Spearhead.  You  can  install  the  Glide  drivers  from  that  directory,  the 
files  are  as  follows: 

glide231.exe  -  Voodoo  Graphics  Glide  2.31  drivers 
monster_3dfx108.exe  -  Monster  board  drivers 
ordchid_3dfx.exe  -  Orchid  board 

Please  install  the  drivers  appropriate  to  your  card.  If  you  do  not  have  a  3DFX  board,  please 
ignore  the  above. 
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4.  You  must  now  modify  your  AUTOEXEC.BAT  file  since  the  RTI  requires  that  some 
environment  variables  are  set.  Add  the  following  lines  to  your  AUTOEXEC.BAT  file.  Please 
note  that  you  will  need  to  change  the  C:\  if  you  installed  to  another  drive  such  as  D:\. 


SET  RTI_HOME=C:\SPEARHEAD\RTI 
SET  RTI_CONFIG=%RTI_HOME%\config 


5.  Before  running  HLA  Spearhead,  you  must  configure  the  RTI  to  work  on  your  machine.  HLA 
Spearhead  WILL  NOT  RUN  until  you  do  so.  Edit  the  following  file: 

C:\Spearhead\RTI\Config\RTI.RID 

Search  for  the  following  text: 

RTI_EXEC_HOST  YOUR_MACHINE_NAME 

Change  the  YOUR_MACHINE_NAME  text  to  the  actual  name  of  your  machine.  To  obtain 
your  machine  name,  go  to  the  properties  tab  of  Network  Neighborhood  and  click  on  the 
Identification  Tab.  Your  actual  machine  name  will  appear  in  the  Computer  Name  field. 

6.  Also,  if  you  are  attempting  to  play  multiplayer  games  in  Spearhead  on  systems  different 
LAN  subnets,  you  will  need  to  add  the  following  line  to  the  AUTOEXEC.BAT  file.  Please 
change  the  netmask  to  match  your  LAN  subnet. 


SET  DTNETMASK=255.255.255. 1 92 


For  the  sake  of  simplicity,  it  is  recommended  that  you  attempt  Spearhead  multiplayer  games 
on  systems  within  the  same  LAN  subnet. 
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Section  6  Section  6  Running  the  HLA  Spearhead  Demo 


Before  running  the  HLA  Spearhead  demo,  it  is  strongly  suggested  that  you  read  the  following 

attached  documents: 

•  Quick  Reference  Guide  -  This  will  give  you  a  quick  outline  of  all  the  keys  and  controls  in 
Spearhead.  From  this  document  you  will  have  an  overview  of  what  features  are  present  in 
the  game  and  how  to  access  them. 

•  Spearhead  Tank  View  and  Controls  -  This  document  will  show  you  all  the  views  in  the 
game,  such  as  driver,  gunner,  commander,  IVIS,  and  how  to  use  them.  Familiarize 
yourself  with  this  document  since  it  contains  important  information  about  each  view,  its 
features  and  related  keyboard/joystick  controls. 

•  Keyboard  Layout  -  keep  this  sheet  handy  for  quick  reference  when  playing  the  game. 

•  Spearhead  Manual  -  This  is  the  full  documentation  for  Spearhead,  it  also  covers  the 
Mission  Editor. 


6.1  Running  the  RTI  Exec 

You  must  run  the  RTI  Exec  before  attempting  either  a  single  player  or  multiplayer  game  in  HLA 
Spearhead.  HLA  Spearhead  will  not  run  unless  the  RTI  Exec  is  running  first! 

To  run  the  RTI  Exec,  go  to  the  Windows  Start  menu,  then  go  to  the  HLA  Spearhead\RTI 
Exec  file  folder  and  run  the  RTI  Exec  program.  You  should  see  a  DOS  console  window  with 
the  RTI  Exec  running  inside  it.  If  the  RTI  is  running  properly,  you  should  see  a  message  of  the 
form: 

Log  Acceptor  open  on  0x00004070 

Note:  The  number  will  change  on  your  system. 


62  Running  HLA  Spearhead 

Once  the  RTI  Exec  is  running,  you  can  now  run  HLA  Spearhead.  To  run  it,  go  to  the  Windows 
Start  menu,  then  go  to  the  HLA  Spearhead  file  folder  and  run  the  Spearhead  program. 

You  should  see  some  introductory  videos,  you  can  short  circuit  these  videos  and  proceed 
directly  to  the  main  menu  by  pressing  the  Space  Bar. 


6.2.1  Run  A  Single  Player  Game  First  To  Test  HLA  Spearhead 

Once  you  are  at  the  main  menu,  attempt  to  play  a  single  player  game  first.  This  is  an  easy 
test  since  only  one  PC  is  required.  When  you  are  at  the  main  menu,  use  the  mouse  to  click  on 
the  following  buttons: 

•  Click  the  Single  Player  button 

•  Click  over  the  Lesson1_MainGun  mission  so  it  is  hi-lighted. 

•  Click  the  Start  Game  Easy  button 


The  mission  will  now  load  and  you  should  see  a  FEDEX  DOS  Console  window  appear  over 
the  game.  Once  the  game  is  loaded,  click  the  mouse  on  the  Spearhead  screen  so  it  has 
the  input  focus  from  the  user. 

•  Press  the  F6  button  so  you  are  in  Gunner  mode 

•  Use  the  Arrow  Keys  to  slew  the  turret  and  press  the  Space  Bar  to  fire  the  main  gun. 

Please  refer  to  the  accompanying  documents  for  other  features  such  as  driving  the  tank,  etc. 

•  Once  you  are  done,  press  Ctrl-X  to  exit  the  game. 

•  You  will  see  a  video,  just  press  the  Space  Bar  to  end  the  video. 

•  Click  the  EXIT  button  to  return  to  the  main  menu. 

You  can  now  play  other  single  player  missions  or  move  on  to  playing  a  multiplayer  game. 


6.2.2  Playing  a  Simple  Multiplayer  Game 

In  order  to  play  a  multiplayer  game,  you  will  need  to  install  HLA  Spearhead  on  two  or  more 
machines.  Only  one  machine  needs  to  run  the  RTI  Exec.  Please  refer  to  the 
accompanying  Spearhead  manual  for  additional  instructions  on  playing  multiplayer 
games. 

You  do  not  need  the  Spearhead  CD-ROM  in  order  to  play,  since  all  the  files  are  copied  on  to 
the  hard  disk. 

Select  a  machine  to  “host”  the  mission  and  another  to  join.  We  will  try  a  simple  two  player 
game.  You  should  get  the  host  running  before  attempting  to  join  a  mission. 

NOTE:  DUE  TO  CURRENT  RTI  RESTRICTIONS,  YOU  CAN  ONLY  PLAN  LAN  GAMES. 
INTERNET  AND  HEAD  TO  HEAD  MODEM  GAMES  WILL  NOT  WORK  AND  WILL  CAUSE 
THE  SYSTEM  TO  CRASH. 
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6.2.2.1  Instructions  for  the  Host  Machine 

Run  The  RTI  Exec  program 
Run  HLA  Spearhead 

When  you  are  at  the  main  menu,  use  the  mouse  to  click  on  the  following  buttons: 

Click  the  Multi  Player  button 
Click  the  IPX/LAN  Button 
Enter  your  name  (i.e.,  Mark) 

Click  the  Host  button 

Click  over  the  Multiplayer00_1on1Test  mission 
Click  the  Create  Def.  Host  button 
Enter  a  mission  name  (i.e.  Test) 

Wait  for  the  joiner 

Click  the  Start  Game  button 

6.2.2.2  Instructions  for  the  Joiner  Machine 

Run  HLA  Spearhead 

When  you  are  at  the  main  menu,  use  the  mouse  to  click  on  the  following  buttons: 

Click  the  Multi  Player  button 
Click  the  IPX/LAN  Button 
Enter  your  name  (i.e.,  Mark) 

Click  the  Join  Defensive  button 

Click  the  OK  button 

Wait  for  the  host  to  start  the  game. 

Once  the  game  is  done  loading  for  both  machines,  you  should  be  facing  one  another.  You  can 
try  shooting,  driving,  etc.  Press  Ctrl-X  when  you  want  to  exit.  You  will  be  returned  to  either  the 
host  or  joiner  screen.  Try  experimenting  with  other  multiplayer  missions,  such  as 

Multiplayer00_2on2Test,  Multiplayer00_3on3Test,  etc. 


4 


6.3  Known  Problems  Running  HLA  Spearhead  Phase  1 

Game  resets  may  not  work  and  could  cause  the  RTI  to  crash.  It  is  recommended  that  you 
completely  exit  Spearhead  (press  Alt-F4  or  the  Exit  button  from  the  main  menu)  before 
attempting  to  run  other  single  or  multiplayer  missions.  This  applies  to  both  the  host  and  joiner 
machines.  The  cause  of  this  problem  was  lack  of  time  to  code  a  robust  reset  sequence  in 
HLA. 

Articulated  parts  do  not  update  on  remote  entities.  While  playing  multiplayer  games  you  will 
notice  that  articulated  body  parts,  such  as  turrets,  will  not  update  their  positions  for  remote 
entities.  Only  local  entities  will  have  updating  functioning  for  art  parts.  This  problem  does  not 
affect  single  player  games. 

On  occasion,  the  RTI  may  refuse  to  connect  with  Spearhead  and  throw  an  exception  that  will 
cause  Spearhead  to  terminate.  When  this  happens,  shut  down  the  RTI,  re-start  the  RTI  and 
Spearhead.  This  is  relatively  rare  occurrence. 

Missions  containing  minefields  will  cause  the  RTI  to  crash  since  Spearhead  assigns  and  ID  of 
0  to  minefields.  The  RTI  cannot  handle  and  ID  of  0.  This  problem  has  been  fixed  in  later 
releases  of  Spearhead. 
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